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Conflict Resolution 

This chapter illustrates how to define conflict resolution methods for your 
replicated environment. The following topics are discussed: 

■ Prepare for Conflict Resolution 

■ Create Conflict Resolution Methods for Update Conflicts 

■ Create Conflict Resolution Methods for Uniqueness Conflicts 

■ Create Conflict Avoidance Methods for Delete Conflicts 

■ Audit Successful Conflict Resolution 
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Prepare for Conflict Resolution 

Though you may take great care in designing your database and front-end 
application to avoid conflicts that may arise between multiple sites in a replicated 
environment, you may not be able to completely eliminate the possibility of 
conflicts. One of the most important aspects of replication is to ensure data 
convergence at all sites participating in the replicated environment. 

When data conflicts occur, you need a mechanism to ensure that the conflict Is 
resolved in accordance with your business rules and that the data converges 
corrccdy at all sites. 

Oracle replication lets you define a conflict resolution system for your database that 
resolves conflicts in accordance with your business rules. If you have a unique 
situation that Oracle's pre-built conflict resolution methods cannot resolve, you 
have the option of building and using your own conflict resolution methods. 

See Also: OrackSi Replication for conceptual information about 
confhct resolution methods and detailed information about data 
convcrponcc for each method 



Brforr you bcRin implementing conflict resolution methods for your replicated 
tables, analyze the data in your system to determine where the most conflicts may 
occur. For example, static data such as an employee nimiber may change very 
infrequently and is not subject to a high occurrence of conflicts. An employee's 
customer assignments, however, may change often and would therefore be prone to 
data conflicts 

Once you have determined where the conflicts are most likely to occur, you need to 
determine how to resolve the conflict. For example, do you want the latest change 
to have precedence, or should one site over another have precedence? 

As you read each of the sections describing the different conflict resolution 
methods, you will learn what each method is best suited for. So. read each section 
and then think about how your business would want to resolve any potential 
conflicts. 

After you have identified the potential problem areas and have determined what 
business rules would resolve the problem, use Oracle's conflict resolution methods 
(or one of your own) to implement a conflict resolution system. 
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Create Conflict Resolution Methods for Update Conflicts 

The most common data conflict occurs when the same row at two or more different 
sites were updated at the same time, or before the deferred transaction from one site 
was successfully propagated to the other sites. 

One method to avoid update conflicts is to implement a synchronous replicated 
environment, though this solution requires large network resource. 

The other solution is to use the Oracle conflict resolution methods to deal with 
update conflicts that may occur when the same row has received two or more 
updates. 

Overwrite and Discard 

The overwrite and discard methods ignore the values from either the originating or 
destination site and therefore can never guarantee convergence with more than one 
master site. These methods are designed to be used by a single master site and mul- 
tiple snapshot sites, or with some form of a user-defined notification facility. 

The overwrite method replaces the current value at the destination site with the 
new value from the originating site. Conversely, the discard method ignores the 
new value from the originating site. 

See Also: "ADD_conflicttype.RESOLUT10N procedure" on 
page 8-78 and "Overwrite and Discard" in OracleSi Replication for 
more information. 



Note: This section uses objects not found in the other scripts 
within this book, because the configuration ORG 1. WORLD. 
ORC2.WORLD, ORC3.WORLD. and SN API. WORLD contains 
three master sites and one snapshot site and is not appropriate for 
OVERWRITE and DISCARD. 
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-The following procecJures need to be executed by the replication adniinistrator . 
OONNECr repadmin/repadndnOsatum. universe 

.-Before you can define any conflict resolution methods, quiesce the 
-master grx3up that contains the table to ^ch you want to apply the 
--conflict resolution method. 

BB6IN 

DBMS REPC3Vr.SDSPENDJ1ASX^KJVCnVITy ( 
GNAME »> 'titanjig' ) ; 

END? 
/ 

-Ml Oracle conflict resolution methods are based on logical oolmm groupings 
-called "column grxwps." Create a column groi?) for your target table by using 
—the DBMS REPCM.MAKEjCDUJMMJSRDOT procedure. 

BBGIN 

IfiMS REPCAT.MAKEjXIi]MNJM)UP ( 
SNAMB s> 'titan', 
CNAME => 'planet', 
CX)UUMNGROUP => 'planet_cgl' , 

IJST 0F_CX3i;aMNJlAMES => ' order, circumference, moons' ) ; 
END; 
/ 

—use the DBMSJffiPCAT.iffDjaPnAIE_RES^ API to define the conflict 
-resolution method for a specified table. This example creates an 
— "Overwrite" conflict resolution method. 

BEGIN 

DBMS^REPCM.ADDJDPDATEJRESOIOTION ( 
S^JAME => 'titan' , 
CNAME 'planet', 
ODIX3MNJ3RCUP ■> 'planet_ogl' , 
SBQUENCEJ3D 1, 
METHOD => 'OVERMRriE', 

PARAMETIER CX^iMIJIRME => ' order, circumf erence, moons' ) ; 
E2ID; 
/ 
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-After you have defined your ccmflict resolution method, regenerate 
--replication support for the. table that received the conflict 
--resolution method. 

BBGIN 

DBMSJlEPOVr.GENERATEJlEPLIOVT^^ ( 
SNAME => 'titan', 
ONAME => 'planet*, 
TyPE => "D^BLE' , 

^m^JC30M^laNIaiTIQN => true) ; 

/ 

—After replication support has been regenerated, resume replication 
—activity by using the RESUMEJflASTEKJOlVITY procedure API. 

BEGIN 

DBMS^REPCAT. RESUME J«\ST^R_ACITVITY ( 
GNRME -*> 'titanjitg') ; 

END; 
/ 



Minimum and Maximum 

When the advanced replication facility detects a conflict with a column group and 
calls either the minimum or /naximum value conflict resolution methods, it compares 
the new value from the originating site with the current value from the destination 
site for a designated column in the column group. You must designate this column 
when you define your conflict resolution method. 

If the new value of the designated column is less than or greater than (depending on 
the method used) the current value, the column group values from the originating 
site are applied at the destination site, assuming that all other errors were success- 
fully resolved for the row. Otherwise the rows remain unchanged. 
—The following procedures need to be executed by the replication administrator. 

CX»INECr repadmin/repadrnin®orcl. world 

—Before you can define any conflict resolution methods, quiesce the 
—master group that contains the table to which you want to apply the 
—conflict resolution method. 
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BBC3IN 

IB^^_REPCAT.SUSPE^©J^ASTE3l_ACTIVITy ( 
OiAME => •SOOtt_mg'); 

EMD; 

/ 

--All Oracle conflict resolution metihods are based cn logical column groupings 
—called "column groups." Create a column group for your target table by using 
--the MMSJlETO^T.^^AKE_(X>LaM^n^ procedure. 

BEGIN 

IB^©_REPCAT.MAKEJD0IjDMNJ3R0^ ( 
SNRME => »SOOtt' , 
CNAME => 'salgrade' , 
aoiI3MN_GROaP -> 'salgrade_pgl' , 
rJ3TjOF_a3LIjNIN_iIAMES => 'losal»); 

END; 

/ 

--0se the DBMSJREPCM*.ADDJUPrmE_RESOUJTION API to define the conflict 
—resolution method for a specified table. This exanple creates a 
— "MINIMaM" conflict resolution method. 

BEGIN 

DBMS_REPCAT.AIX»_UPDAIE_RE9CaOTIQN ( 
SlIAME -> 'SCOtt', 
GNAMB s> * salgrade ' , 
OOUJtmjSPaJP => »salgrade_cgl', 

SEQOENCE_iro => 1, 
METHOD => »MINIMDM', 
PARAMETCRjCX]ia>flN_NAMB »> 'losal'); 

END; 
/ 

--After you have defined your conflict resolution method, regenerate 
—replication support for the table that received the conflict 
— resolution method. 
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BEGIN 

DBMS_I^CAT.GENERATE_REPLICATIC3N_ ( 
SNAMB => 'scott', 
QNAME s> *salgradeS 
TYPE => 'TABLE' , 

mvijxjtmsiacATiON => true) ; 

END; 
/ 

--After replication support has been regenerated, resume replication 
—activity by using the RESDMEJIASrERJVCrriVITO procedure API. 

BEGIN 

DBI^J^EPCAT.RESOMEJflASTERJtfri^ ( 
OJAME => 'soott_irg' ) ; 

END; 
/ 

Timestamp 

The earliest timestamp and latest timestamp nnethods are variations on the minimum 
and maximum value methods. To use the timestamp method, you must designate a 
column in the replicated table of type DATE. When an appUcatlon updates any col- 
umn in a column group, the application must also update the value of the desig- 
nated Uraestamp column with the local SYSDATE. For a change applied from 
another site, the timestamp value should be set to the timestamp value from the 
originating site. 

Several elements are needed to make timestamp contlict resolution work well: 

• Synchronized Time Settings Between Computers 

• Timestamp field and trigger to automatically record timestamp 

—■The following procedures need to be executed by the replication administrator. 

ODiJNECr tepadmin/repadminOorcl . world 

—Before you can define any conflict resolution methods, quiesce the 
—master group that contains the table to \*4iich you want to apply the 
—conflict resolution method. 
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BEGIN 

DB^^_REPCAT.SUSPE^DJ'lASTER_ACTlVIaY ( 
GNAME -> ' scotc_mg ' ) ; 

WD; 

I 

—It the target table does not already contain a timestanp field, 
— then add an additional cxDlumn to your table to recx>rd the 
--timestamp value when a row is inserted or updated. Additionally, 
--you nuist use the ALTERJ-lASTER^REPCSJECr API to apply the EDL to 
—the target table. Simply issuing the n3L nay cause the replicated 
—object to become invalid. 

BEGIN 

DBMS_REPCM.ALT13O1ASTER_REP0BJBCr ( 
SNAMB => 'soQtt', 
CNAME => »enip', 
TYPE => 'lABIiE' , 

EDL_TEXT => » ALTER TftBIS scott.emp AED (timestanp DATE) M ; 

END; 
/ 

--After you liave inserted a new colunai into your replicated object, 
--make sure that you re-generate replication siq^port for the 
—affected object. This step should be perforned inimiediately 
--after you alter the replicated abject. 

BE9GIN 

DBh^_REPCAT. GENERATE JlEPLia^TION_SUPPORT { 
SNAME => 'soott^ 
ONAMB => *enp', 
TYPE => 'TABLE', 
mNjOCMCNICATIC^ => TTIDE) ; 

END; 
/ 

--Once tlie tiniestanp field has been created, create a trigger 

--that records the timestanp of when a row is either inserted 

—or updated. This recorded value is used in the resolution of 

--conflicts based on the Timestainp method. Instead of directly executing the 

— EDL, you should use the IBMS^REPCAT. CREATE J1ASTERJ?EBDBJECT procedure to 

—create the trigger and add it to your iraster group. 
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BEGIN 

DBMS_REPCAT.CI^TE_^^1ERJ^EPC»JEC^ ( 
GNT^ => 'scott__mg', 
TOTE s> 'TRIGGER', 
CNAMB => 'insert_tiine' , 
SNAME => 'scott', 

EDLJTEXr 'CREATE TRIOGER soott .insert_tiine 
BEFORE 

INSERT OR UPDATE ON scott.ertp FOR EACH ROW 
BEGIN 

IF EeMSJ?EEajnL.F501_REMDTE = FALSE THEN 

;NEW.TIMESTAMP SYSDATE; 
END IF; 
END; • ) ; 

END; 

/ 

BEGIN 

DBMS_REPCAT.GENERATE_REPLICATION_SUPP0RT ( 

SNAME ^> 'BOOtt' , 
CNAME => 'insert^time' , 
T£PE => 'TRIGGER' , 
KENjDGIMKiaVITGN => TRUE); . 

END; 
/ 

—All Oracle canfUct resolution nethods are based on logical oolunn groupings 
—called "column gratis." Create a column groi^p for your target table by using 
—the J(EBCkT.mKEJ30WmjS9£XfP procedhare. 

BEGIN 

IBNBJIEPCM.MAKEJCDU3MNJ3RDDP ( 
SNAI-E ' soott ' , 
QNAME => 'einp' , 
CDUMNJGRDOP => 'eitp^cgl', 

UST aF_a3IJ)MN_NAMES »> 'mgr, hiredate, sal, tinestanp ' } ; 

END; 
/ 
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—Use the DBMSJ?EPC3ff.ArojOPmTE_RES(X^ API to define the conflict 
—resolution netbod for a specified table. Tkiis exan5)le specifies the 
— "lATEST TIMESrftMP*' conflict resolution method using the TIMESrAMP column 
— that you created earlier. 

BEGIN 

IBMS_REPCOT.W35JDPDATEJ?E90U7nCW ( 
SSWSE => 'SCOtt' , 
CNAME => *einp' , 
(XfLVmjSXXJP => »enp_ogl', 
SEQUESCEJ^ »> If 
MEmJD => 'lATEST TIMESTAMP' , 
PiU^A^3E^:ERJCXXUMN_NAME => ' tiraestarp ' ) ; 

END; 
/ 

--After you have defined your conflict resolution method, regenerate 
--replication support for the table that received the conflict 
--resolution method. 

BEGIN 

DBh^_REPCAT. GENERATE J?EPIJC3^TI0N_SUPPC^ ( 
SNAME => ' scott * , 
CMRME => 'enp', 
TYPE => 'TABLES 
hUNjOOMMONICATION => TRUE) ; 

END; 
/ 

--After replication support has been regenerated, resume replication 
--activity by using the RESUMEJlASTERJ^CTIvriY procedure API. 

BEGIN 

DBMS_REPCAT.RESnaME_MASTER_ACTIVITY ( 
GURME »> *scott_jngM; 

END; 
/ 
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Additive and Average 

The additive and average methods work with column groups consisting of a single 
numeric cohimn only. Instead of "accepting" one value over another, this conflict 
resolution method either adds the two compared values together or takes an aver- 
age of the two compared values. 

—The following procedures need to be executed by the replication administrator. 
craJNECT repadmin/repadminOorcl .world 

—Before you can define any conflict resolution methods, quiesce the 
—master group that contains the table to which you want to apply the 
— conflict resolution nethod. 

BEX1[N 

I»MS_I^COT.SUSPEb©J>C\STER_ACTIVIlY ( 
QJWffi => *scott_mgM; 

END; 
/ 

--All Oracle conflict resolution methods are based on logical column groupings 
—called "column grot^a." Create a column group for your target table by using 
—the DB^e_IffiPCAT.MAKE_caLUMNJ3^^ procedure. 

BEGIN 

DBMSJREPCAT.MAKEJCDU}MNJ33RC3C^ ( 
=> *SCOtt\ 
OlAME => 'boanus' , 
GDUJMNjGROOP => 'banus^ogl', 
IJST_OF_OQXJMIJ©WES »sal'); 

END; 
/ 

—Use the DBMSJCTGAT.AmjapnftlEJ^ESOE^ API to define the conflict 
—resolution irethod for a specified table, this exanple specifies the 
— "ADDITIVE" conflict resolution method using the SAL column. 
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BEGIN 

I»MS_REPCaT.iU2D_CPDAIEJ?ESaL17nON ( 
SNAME => 'scxDtt', 
CNAME => 'bonus', 
CDIAJMNGROOP => »bonus_cgl', 
SEQUENCEJO -> 1, 
MSTHOD -> »MDITIVB', 

parambierjcxxamnjsvme; 'sal*}; 

END; 
/ 

— After you have defined your conflict resolution method, regenerate 
—replication support for the table that received the conflict 
— resolution method. 

BEGIN 

IBMS_REPC3Vr ,GENERATE_REPIjICATI(»I_S0PPORT ( 
SNAME => »scott' , 
CNAME => 'ban\;is', 
TYPE => 'TABLE', 
MINJOOKMONICATICN => TRUE) ; 

END; 
/ 

— After replication support has been regenerated, resume replication 
--activity by using the RESDMEJMASTER^ACriVHY procedure API. 

BEGIN 

DBMS^REPGKT . RESUME_W^STER_ACilVlT5f ( 
GaCiME «> 'scott_mg'); 

END; 
/ 
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Priority Groups 

Priority groups allow you to assign a priority level to each possible value of a 
parricular column. Tf Oracle detects a conflict, Oracle updates the table whose 
"priority" column has a lower value using the data from the table with the higher 
priority value. 

OQNNECr repadinin/repadinii3®arcl.vorld 
BEGIN 

DB^E_REPCAT.SlJSPE^©_MAffI:ER_AC^^ ( 
O^ANE => 'soott_mg'); 

/ 

--►Wee sure that the JCe field is part of the column group that your 

• -Bite priority cxanflict resoluticxn mechanism is used for. Use the 

■ - ADD CWCXJPO^COLDMN procedure to add this field to an existing column group. 

• < It ychx cb not already have a colum group, you can create a new column group 
--ueuKi tlK DeMSJ^EPaT-MAKE^CntiOMNJ^ procedure. 

QCil-E -> 'scott\ 
GKAME -> 'emp', 
COUJMN_GROOP => 'errp_cgl', 

lJST_OF_a3I^JMN_NH^3ES => 'mgr, hiredate, sal, jobO ; 

/ 

•♦Before you begin assigning a priority value to the values in your table, you 
--inist create a priority group that "holds" the values that you defined. 

BbGIN 

DBMS_REPCAT.DEFTlffi_ERI0iaTyjSROlJP ( 
C5C^E => 'scott_ing», 
PGROOP => 'job_pg', 
DATATYPE ' V7VRaJAR2 ' ) ; 

/ 
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— Tte DBMS__REPCAT.ADD_PRIORITY_datatype procedure is avaiable in several 
--different versions. There is a version for each available datatype 

(NUMBER, VARC3IAR2, and SO on). See "ADp_PRIQRnY_datatype procedure" 
— on page 8-75 for more information. Execute this API as often as 
— necessary wtil you have defined a priority value for all possible 
--table values. 

BEGIN 

DBMS_I^CAT.Am_PI^0RITbrVARCHAR2 ( 
G^JAMB => 'scott_mg*, 
PGROOP »> *job_pg», 
VMJ3B => ^presidmt', 
PRIORITY => ICQ) ; 

END; 
/ 

BEGIN 

DBP©_REPCAT.AnD_PRiaRITyj«RC3^ ( 
GN7\ME => *soott_mg', 
PGROUP => 'job_pg', 
WJUB s> 'managers 
PRIORITY => 80) ; 

END; 
/ 

BEGIN 

DBMS_REPaiT.iUXLPI^ORITyji!ARC3»R2 ( 
GN2^ => ' soott^mg ' , 
PGROUP => 'job_j)g', 
VALUE 'salesman*, 
PRIORITY => 60) ; 

END; 
/ 

BEGIN 

IBMS_REPCAT.Am_PRICRITY_\mRCHAR2 ( 
QJAME =s> 'soott_mg', 
PGRCUP => 'job^pg', 
VA3JUE => 'analyst', 
PRIORITY => 40} ; 

WO; 

I 
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BEGIN 

IBMS_REPCAT.AIXi_PRIORITX'jmRCHAI^ ( 
QBVME ==> 'scott mg' , 
PGROUP => ' jobj)g», 
VRUJE => 'clerk*, 
ERIQiaiY «> 20) ; 

END; 
/ 

—After you have completed assigning your priority values, add the 
—PRIORITY GRCDP resolution method to your replicated table. The following API 
— exanple shews that it is the second conflict resolution method for the 
--specified coluimi group (SBCyiEaraSJK)) . 

BEXaIN 

ra>1S_REPC3a'.ADDJ3EDMEJ?E90LOn ( 
SNAME => ' scOtt' , 

a)IJUMNj3R00P => 'enpjcgl', 

SBQUENCE^NO 2, 

METODD => 'PRICHITy GROUP', 

PARAMETER_00LTM3LNAME => 'jdb», 
pKlCa<ITx_GRaOP => »jobj>g'); 

END; 
/ 

—After you have defined your conflict resolution method, regenerate 
--replication support for the table that received the conflict 
—resolution method. 

BEGIN 

DBMS^REPOVT. GENERATE J?EPIJCATIQN_SOPP0^ ( 
SNAME => 'scott' , 
ONAME s> 'eirp" , 
TYPE => 'TABLE' , 

MiN_oc»raNiC3vnai => TRDE) ; 

END; 
/ 
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—After r^lication support has been regenerated, resume replication 
—activity by using the RESUMEjflAOTRJCTIvrry procedure API. 

BEX3IN 

Da*lS_REPCAT.RESUNIE_MASTER_ACr^ ( 
OJAME *> 'scott^mg') ; 

END; 
/ 

Site Priority 

Site priority is a specialized form of priority groups. Therefore, many of the proce- 
dures associated with site priority behave similarly to the procedures associated 
with priority groups. Instead of resolving a conflict based on the priority of a field's 
value, the conflict is resolved based on the priority of the sites involved. 

For example, if you assign ORC2-WORLD a higher priority value than 
ORCl. WORLD and a conflict arises between these two sites, the value from 
ORC2.WORLD is used. 

OQNNECr rt^>admiii/repadntin®orcl.v«orld 
BEX3IN 

DBMS_REPavr,SUSPEND_MASTEKJVCrrVITY ( 
GNAME => 'scott_mg'); 

END; 
/ 

--You must add a SITE column to your table to store the site value in 
—your replicated table. Use the DBMS J^EPCAT. ALTER J^IASriER_REPCBJ^^ procedure 
—to apply the DOI* to the target table. Sinply issuing the DDL may cause 
—the replicated object to become invalid. 

BEGIN 

DBMS_REPCAT.ALTI3^_MASTER_REPOBJBCr ( 
SNAMB => *S0Ott' , 
GNAME => 'eitp' , 
TYPE => 'TRRTiE\ 

EDIiJTEXT => 'AIJER TMIfi soott.eiip AED (site VARCHRR2 (20) ) ' ) ; 

END; 

/ 
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--After you have inserted a new column into your replicated object, 
--make sure that you re-generate replication support for the 
--affected object. Uiis step should be performed iitwmediately 
—after you alter t:he replicated abject. 

BEGIN 

DB^^_REPCAT.GENE3«VTEJ?EPLICATIa^^_SDPH<^ ( 
SNftNE => ' scott • , 
ONAMS *enp\ 
TYPE => •TABLE*, 
MIN_C3QMM0NICATiaN TROE) ; 

WD; 
I 

--After you have added the SHE column to your table, make sure 

--that this field is part of the column groi^j that your site 

— priority conflict resolution mechanism is used for. Use the 

--ADDj3R0DPED_p0U3MN procedure to add this field to an existing 

— column group. If you do not already have a column group, you can create a 

—new column group using the DB^©_REPCAT.MAKEJCDLUMNJ3R0□P procedure. 

BEGIN 

dbms_reihzat.make_(X>i™njs^^ ( 

SNAME => 'scott' , 
CNAME => 'eirpS 
ODUlMNjSRCXrP 'errp^ogl', 

IjISTJ3F_CX3EJMN_NftMES 'mgr, hiredate, sal, site'); 

END; 
/ 

— Before you begin assigning a site priority value to the sites in your 
—replicated environment, you must create a site priority group that "holds" 
— the values that you defined. 

BEGIN 

IB^©_REPCAT.DEFINE_SITE_PRIORITY ( 

GNAiME => ^scott_mg', 
NAME => 'sitejpg'); 

END; 
/ 

— Define the priority value for each of the sites in your replication 
--enviranment using the DBMS_FEPCAT.ADp__SITE_PRIORITY_SrrE procedure. 
— Execute this API as often as necessary until you have defined a site 
— priority value for each of the sites in our replication environroent. 
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BEGIN 

DBMS_REPaff.AIXLSITE_PRIORITy_SITE ( 
C3«AME => 'scott_nig', 
UM^E • site_pg ' , 
SITE => 'orcl. world', 
PRICaim => 100) ; 

END; 
/ 

BEGIN 

QIAME => * scott_iTig ' , 
NAME => ' sitejpg * , 
SITE => »orc2.vorld' , 
ERIORITSf => 50); 

END; 
/ 

BEGIN 

rBhB_REPCAr.i^_srrE_PRioiaTyjsrrE ( 

GNAME *scott_ng», 
NAME => »site_pg*, 
SITE => 'orc3. world', 
FRIORir/ 25); 

END; 
/ 

--After you liave conpleted assigning your site priority values, add the 
-'SITE PRIORITY resolution method to your replicated table. The following 
--API ejcamples shows that it is the third conflict resolution method 
--for the specified column group (SBQUENCE_NO) . 

RBGIN 

DBMS_REPavr./^3D_t3PDATE_RESOLUnCH ( 
SNW'E -> *SCOtt' , 
ONAME => 'emp' , 
CDUJMNJGROUP => 'eftp^cgl*, 
SEQGEI^CEJNO => 3, 
METHOD => 'site priority', 
PARAMETERjTOMMNJNAME «> 'site*, 
PRIORITYJSROOP »site _J3g' ) ; 

END; 

/ 
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—After you have ctefined your conflict resolution method, regenerate 
—r^lication support for the table that received the conflict 
--resolution method. 

BEX3IN 

DBMS_REPavr.GENERATEJREPLiavriON_SUPPORT ( 
SNAh-E => 'scott', 

TTPE => 'TABLE', 
MIN_CX>iMUNlCaTION => TRUE) ; 

END; 
/ 

—After r^lication sv^port has been regaierated, resume replication 
—activity b/ usijng the reESUMEJ^ASTERJwnxvriY procedure API . 

BEGIN 

DBMS_REPC3VT.RESt5ME_MASTER_ACTIVITy ( 
GNAMB => 'soott_mg' ) ; 

END; 
/ 

Create Conflict Resolution Methods for Uniqueness Conflicts 

In a replicated environment, you may encounter situations where you receive a 
conflict on a unique constraint, often resulting from an insert. If your business rules 
allow you to delete the duplicate row. you can define such resolution with Oracle's 
pre-built conflict resolution methods. 

More often, however, you probably want to modify the conflicting value so that It 
no longer violates the imique constraint. Modifying the conflicting value ensures 
that you do not lose important data, Oracle's pre-built uniqueness conflict 
resolution method can make the conflicting value unique by appending a site name 
or a sequence number to the value. 

An additional component that accompanies uniqueness conflict resohiti on methods 
is a notification facility. The conflicting information is modified by Oracle so that it 
can be inserted into the table, but you should be notified so that you can analyze the 
conflict to determine whether the record should be deleted, or the data merged into 
another record, or a completely new value be defined for the conflicting data. 
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--Hie following pxocedures need to be executed by the replication administrator. 

CDMNECr repadmin/repadminSorcl . vrorld 

BBGIN 

IBMSJREPCW . S^JSPE^©J»4ASTER_ACITVITY ( 
GNAMB «> < scott_ing ' ) ; 

END; 
/ 

— As you might esqpect, a uniqueness conflict resolution method detects and 
--resolves conflicts encountered on columns with a UNIQUE constraint. Use 
--the ALTER_MASTER_REPQBJBCr procedure (described on page 8-83) to add 
—a UNIQUE constraint tio the table. 

BEGIN 

DBMS_REPCOT,iUjrER_MASTER_REPOBJBCT ( 
SNAM5 s> 'scott', 
C»IAME => 'enp', 
TYPE => "EABUS' , 

EOLJTEXT => 'ALTER TARTiK scott.emp ADD 

(constraint enpjenamejiinique UNIQUE (ename) ) ' ) ; 

END; 
/ 

—After you have added the UNIQUE constraint to your replicated table, 
—make sure that you regenerate r^lication si^port for 
—the affected table. Uiis step should be performed ifimnediately 
—after you alter the replicated oibject. 

BE3SIN 

DB^@_REPaVT.GENERATBJREFIlICATI(]N_SUPPQRT ( 
SNAME => 'scott', 
ONAME => 'eirp' , 
TYPE => 'TABLE', 

MiNjac»MaNi(3\riON => true) ; 

END; 
/ 
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—The following table (conf^report) stores the messages received from 
--your notification facility. 

BEGIN 

DBMS J?EPCAT . EJCEXXriE^EDL ( 
GNAMB s=> 'scXDttjng', 

EDLJIEJCT => 'CREATE TARTiK scxstt-oanf^report { 
line NDMBER(2) , 
txt VARCHAR2(80), 
tiroes taiip DAIE, 
table^name VARa3AR2 (30) , 
table^owner VARCHAR2 (30) , 
oonf lict^type VARCKAR2 (7) ) » ) ; 

END; 
/ 

GCSNMECr soott/tigerSorcl.MsrId 

— Ihe following package (notify) sends a notificatiai to the CJDNF^REPQRT 
—table «ten a conflict is detected. 

--The conflict resolution notification package that is created in this script is 
'-described in detail in i^pendix B, "User-Defined Conflict Resolution MethocSs". 

CPEKTE OR REPLACE PACKAGE notify AS 

RJNCnON enp_uniquejvlolation (enane IN OUT VARCHAR2, 
discard_new_values IN OUT BOQIjES^) 

RKIDRN BCX3I£AN; 
END notify; 
/ 
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CREATE OR REPLACE PACKAGE BOOT notify AS 

TYPE message^table IS TOBUE OP VARCHAR2 (80) UJDEX BY BINARY^INIBGER; 
PROCEDfORE report_conf lict (cxaif lict^report IN MESSAGE JEABLE, 
report_length IN NDMBER, 
oonflict_tijne IN DATE, 
canflict_table IN VARCHAR2, 
table jowner IN VARCHAR2, 
canflict_type IN VARCHAR2) IS 
BEGIN 

FDR idx IN 1. . repor t_length liOOP 
BBSIN 

INSERT INTO scx)tt . conf ^report 

(line, txt, tiitBstanp, tablejiame, tablejowner, conflict_type) 
VAUIES (idx, SUBSTR(canflict_report(icbc) , 1,80) , oonf lict_time , 
canflict_table, table_owner, coif lict_type) ; 
EXCEPTION WHEN others THEN NULL; 
END; 
END LOOP; 
END report^conflict; 
FUNCTION einp_unique_violatiari(eriaine IN OUT VARCHAR2, 

discardjnewjvalues IN OUT B0QLE3VN) 
RETURN BOOI£AN IS 

localjiode VARaBVR2 (128) ; 
conf_report MESSAGE JIABr£; 
cxmf^tine DATE := SYSDATE; 
BEGIN 
BEGIN 

SELfiCT global_name INTO localjode FROM globaljiame; 
EXCEPnCN WHEN Others THEN local_node := ; 

WD; 

conf_report(l) := 'UNIQUENESS OGNFLICr DETECTED IN TABLE EMP ON » | | 

T0_CHAR(COnf_tiine, '^3M-DD-YYYY HH24:MI:SS' ) ; 
conf_report(2) := ' AT NODE ' || local_node; 
Conf_report(3) := 'ATTEMPTING TO RESOLVE CONFLICT USING' jj 

• APPEND SITE NAME MEIUDD*; 
oonf_i:eport(4) := 'ENAME: ' || ename; 
CX3nf_repQrt(5) := NULL; 

report_oanflict{ccnf_report, 5, conf^time, 'EMP', 'SOOTT', 'UNIQUE'); 

discard_new_values := FALSE; 

RETURN fALSE; 
END erp_unique_violation; 
END notify; 
/ 
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OCNNECr repadmiii/repadmin®orcl. world 

—the following package is replicated to all of the master sites in ycRor 
—replication enviromnent, which ensures that the notification facility is 
—available at all master sites. 

BEGIN 

IBf^_I^CAT.CREATE_MASTER_REPC»aECr ( 
=> 'scott_mg', 

TYPE 'PACEOVSE', t 

ONfiME => 'notify*, 
SNAME *soott'); 

/ 

BEX3IN 

IBMS_REPCAT.CREATE_MASTERJffiK^ ( 
a®MB => 'soottjmg', 
XyPE => 'PACKAGE BCEY*, 
ONAME => 'notify', 
SNAME => 'soott' ) ; 

/ 

—After you have oortpleted building your notification facility, add the 
—notification facility as one of your conflict resolution methods, 
-even though it only notifies of a conflict. The fol lowin g API example 
-demcinstrates adding the notification facility as a USER FUNCTICai. 

BEGIN 

I^vB REPCOT.AEDJDNICPE_RESOLXrriCN( 
SNAME => 'scott', 
CaiAME => 'enp', 

C30N5rRAINT_NAME => ' en?>_ename_unique ' , 

SEQOENCEJJO «> 1, 

METHOD => 'USER FQNCITCN' , 

OOMMEOT => 'Notify DBA', 

PARAF3EIERJX2UJMNJJAME => 'enarae', 

FONCriONMttflE => 'soott.notify.enpjunique_violaticn') ; 

END; 

/ 
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--After you liave added the notification facility, you are ready to add the 
—actual conflict resolution method to your table. Hie following API example 
—demonstrates adding the APPEND SITE! NAME uniqueness conflict resolution 
—method to your replicated table. 

BEGIN 

DBMS_REPCAT . ADDJIOTQCIEJ^ESOLUriCN ( 
SNAMB *SOOtt' , 

QNAME => ^emp\ 

CDNSTRAINr_NAME => ' enp^enaraejunique * , 
SBC3DENCEJ3D ==> 2, 
METHOD => 'APPEND SITE NAME', 
EARAMETER^OOimNJNAME «> 'enarae'); 

E^ID; 
/ 

—After you have defined your conflict resolution methods, regenerate 
—replication support for the table that received the conflict 
—resolution methods. 

BEGIN 

DBMS_REPCM. GENERATE J?EPIiICATICaT_SaPPORT ( 
SNAME => 'SOOtt', 
ONAME => 'eirp', 
TYPE => 'TSfflLE', 
MIN_C30mUNlCATTON => TRUE) ; 

m): 
/ 

—After replication support has been regenerated, resume replication 
—activity by using the IffiSOMEJIASIER^ACTIVITY procedure API. 

BEGIN 

I:BI^_REPC3VT.RESU^E_MASTERJ^CITVI^Y ( 
OJAME => 'soott_mg'); 

/ 
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Create Conflict Avoidance Methods for Delete Conflicts 

Unlike update conflicts, where there are two values to compare, simply deleting a 
row makes the update conflict resolution methods described in the previous section 
ineffective because only one value would exist 

The best way to deal with deleting rows in a replication environment is to "avoid" 
the conflict by marking a row for deletion and periodically pui^ing the table of all 
"marked" records. Because you are not physically removing this row, your data can 
converge at all master sites if a conflict arises because you still have two values to 
compare, assuming that no other errors have occurred. After you are sure that your 
data has converged, you can purge "marked" rows using a replicated purge 
procedure. 

When you arc developing your firont-end application for your database, you 
pmhnbly want to "filter out" the rows that have been marked for deletion, because 
domp so makes it appear to your users as though the row was physically deleted. 
Simply exclude the rows that have been marked for deletion in the SELECT 
stairment for your data set. For example, a select statement for a current employee 
lLsim^» miRhi be similar to the following: 

SEUQCT * PRCM enip WHERE removejdtate IS KULL; 

This section describes how to prepare your replicated table to avoid delete conflicts. 
\o\j also see how to use procedural replication to piirge those records that have 
been "marked" for deletion. 

OOtwasCT tepadmin/repadndn^occl.vorld 

BFCIN 

n3MS_REPC3Vr.SlBPEMD_MASTERJVCrTVITY ( 
GtWE •sGOttjng'); 

END; 
/ 
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--You must add a column to your replicated table that stores the 

--mark for deleted records. It is advisable to use a timestamp to mark your 

--records for deletion (timestanp reflects vAiai the record was marked for 

— deletion) , Because you are using a timestamp, your new colxjsnn must be 

—a EtAIE datatype. Xfee the MMS_RBPCAT.AL1ERJ4RSIER_REPC®JBCT procedure to add 

—the REM3VE_DAIE coluinn to your existing replicated table. 

BEX5IN 

DBMS_REPCAT.ALTER_MASTER_REPC»JiCT ( 
StOVMB => 'scott* , 
CNAME => 'emp' , 
TYPE «> 'TABLE' , 

VOLTEXr => 'ALTER T3VBI£ soott.en^ (removejdiate DATE) ') ; 

Em; 
I 

— After you have inserted a new column into your replicated object, 
— make sure that you regenerate replication svqpport for 
— the affected object. This step should be performed iimimediately 
—after you alter the replicated object. 

BEGIN 

DBMS_REPC3^T. GENERATE JflEPLIC3VnON_SUPPORr ( 
SNAMB => ' scott » , 
QNAME 'enp', 
TYPE => 'TABLE', 
NaNJX^MONICATION => TRUE) ; 

EMD; 
/ 
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--ihe following package is replicated to all of the master sites in your 
--replication environment. This package purges all "marked" records from 
--the specified table. 

BEGIN 

IBMS_REPCOT.CREATEJ1ASTERJ?EP0BJECT ( 
GNAME => 'soott__mg', 
TYPE => 'PACKfiGE', 
ONAME => 'purge*, 
SNAME 'SCOtt' , 

DDLJTE^Cr «> OR REPIACE PAC3CAGE scott. purge AS 

PROCEDORE renove^enqp (purge jdate VkTE) ; 
END;»); 

END; 
/ 

BEGIN 

I:B^G_REP<3a'. CREATE J>1AS1ERJ?ER^JECT ( 
GNANE => 'scott^mg', 
TYPE *> 'PACKfiGE BOOT', 
ONPME => 'purge' , 
SNAME => 'scott*, 

DDLTEXT => '(CREATE OR REPIACE PAC3(AGE BODY SCOtt. purge AS 
PROCEDURE remove_enp (purge_date IM DATE) IS 
BE3GIN 

DBMS^REPOTIL . REELICATTONOFP ; 

DOCK TABLE scott.enp IN EXCLUSIVE MODE; 

DELETE scott. enp VZHERE ratKJve^date IS NOT NULL AND 

removejdate < purge_date; 
IBMSJ?EPUnL.REPLICATIONjCW; 
EXCEETION WHEN Others THEN 

IBMS^REPOnL. REPUCATIONON; 
END; 
END;'); 

WD; 
I 
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--After you have created your padcage (package ard padcage boc^) , generate 
--replication support for each component. After you generate 
--replication support, a synonym is created for you and added to your 
--master gcaap as a replicated object. This synoanym is labeled as 
- - DEFER_PURGE . REMCfVE_EMP . 

BEX3IN 

IB^S_REPCOT.G^^ERATE_REPIlIC2^TIQN_SDPP0RT ( 
SNAME => 'scott' , 
ONAME => 'purge', 
TYPE -> 'PACKAGE', 
MIN_a>MUNICATION TRUE) ; 

/ 

REPORT. GENERATE_REPLlCATrON_S0PKKr ( 
SNA^E 'soottS 
CNAME •> 'purge' , 
TYPE •> 'PAOCftGE BODY', 
MIN_CC»*«Ja«CATlON »> TRDE) ; 

/ 

--After replxcation support has been regenerated, resijnne replication 
--activity by using the RESOME_MASTER_ACTlVi'iY procedure API. 

t3BMS_REPC3Vr.RESU>E_MASTERJ\CI^^ ( 
GNAME *> 'scott_nng'); 

QJD; 

/ 
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Audit Successful Conflict Resolution 

Whenever Oracle detects and successfuUy resolves an update, delete, or uniqueness 
conflict vou can view information about what method was used to resolve the 
conflict by querying the DBA_REPRESOLUTION_STATISTICS data dictionaiy 
view. This view is updated only if you have chosen to turn on conflict resolution 
statistics gathering for the table involved in the conflict. 

See Also: The ALL_REPRES0LUT10N_STATISTICS on page 9-32 

for more information. 

Gathering Conflict Resolution Statistics 

Use the REGISTER STATISTICS procedure in the DBMS_REPCAT paclcage to 
collect information about the successful resolution of update, delete, and 
uniqueness conflicts for a table. The following example gathers statistics for the 
EMP table in the ACCT_REC schema: 

IBMS_REPCAT.RBSISIER_SransnCS(snaine => 'acct_rec', 

aname => ' enp' ) ; 

See Also: The REGISTER_STATISnCS procedure on page 8-140 
for more information. 

Viewing Conflict Resolution Statistics 

After vou call REGISTER.STATISTICS for a table, each conflict that is successfully 
Tesolved for that table is logged in the DBA_REPRESOLUTION_ STATISTICS view. 
Information about unresolved conflicts is ahvays logged to the DEFERROR view, 
whether the object is registered or not. 

See Also: ALL_REPRESOLUTION_STATlSTICS on page 9-32 and 

DEFERROR on page 9-49 for more information. 
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Canceling Conflict Resolution Statistics 

Use the CANCEL_STATISTICS procedure in the DBMS_REPCAT package if you no 
longer want to collect infomiation about the successful resolution of update, delete, 
and uniqueness conflicts for a table. The foUowlng example cancels statistics 
gathering on the EMP table in the ACCT.REC schema: 

iaMS_REPC3Cr.CKtJCm._SrATISTICS(snaine => ' acct_rec' , 

onaite => ' wp' ) ; 

See Also: The CANCEL.STATISTICS procedure on page 8-91 for 
more information. 



Deleting Statistics Information 

If you registered a table to log information about the successful resolution of 
update delete, and uniqueness conflicts, you can remove this information from th 
DBA_REPRES0LLJTI0N_STATIST1CS view by calling the PURGE.STATISTICS 
procedure in the DBMS_REPCAT package. 

The foUowing example pui^es the statistics gathered about conflicts resolved due 
inserts, updates, and deletes on the EMP table between January 1 and March 31: 

DBMSJREPCRT . PUR3E_STRXISTICS (sname => ' acct_rec' , 

caiame => 'erp', 

start_date => 'Ol-JAN-99', 

aidjdate => '31-MAR-99) ; 

See Also: The PURGE_STATISTICS procedure on page 8-136 for 
more information. 
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